From e56bb49407534297fa74c194783301d8fc1bb844 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Mon, 2 Nov 2015 12:53:57 -0500
Subject: [PATCH] popover: Document differentiating style classes

There's a lot of popover variations out there.
---
 gtk/gtkpopover.c | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/gtk/gtkpopover.c b/gtk/gtkpopover.c
index 1861dfbbb0..b9e30fba4e 100644
--- a/gtk/gtkpopover.c
+++ b/gtk/gtkpopover.c
@@ -71,9 +71,16 @@
  * </section>
  * ]|
  *
- * A popover has a single css node called "popover" and gets the
- * .menu style class in case it has been created using
- * gtk_popover_new_from_model.
+ * # CSS nodes
+ *
+ * GtkPopover has a single css node called popover and gets the
+ * .menu style class if it is menu-like (e.g. #GtkPopoverMenu or
+ * created using gtk_popover_new_from_model().
+ *
+ * Particular uses of GtkPopover, such as touch selection popups
+ * or magnifiers in #GtkEntry or #GtkTextView get style classes
+ * like .touch-selection or .magnifier to differentiate from
+ * plain popovers.
  *
  * Since: 3.12
  */
-- 
2.30.2